home *** CD-ROM | disk | FTP | other *** search
/ Enter 2004 January / enter-2004-01.iso / files / maxima-5.9.0.exe / {app} / info / maxima.info-14 < prev    next >
Encoding:
Text File  |  2003-02-09  |  5.4 KB  |  166 lines
  1. This is maxima.info, produced by makeinfo version 4.1 from maxima.texi.
  2.  
  3.    This is a Texinfo Maxima Manual
  4.  
  5.    Copyright 1994,2001 William F. Schelter
  6.  
  7. START-INFO-DIR-ENTRY
  8. * Maxima: (maxima).     A computer algebra system.
  9. END-INFO-DIR-ENTRY
  10.  
  11. 
  12. File: maxima.info,  Node: Keyword Commands,  Next: Definitions for Debugging,  Prev: Source Level Debugging,  Up: Debugging
  13.  
  14. Keyword Commands
  15. ================
  16.  
  17.    Break commands start with ':'.   Thus to evaluate a lisp form you
  18. may type `:lisp ' followed by the argument which is the form to be
  19. evaluated.
  20.      (C3) :lisp (+ 2 3)
  21.      5
  22.    The number of arguments taken depends on the particular command.
  23. Also you need not type the whole command, just enough to be unique among
  24. the keyword commands.   Thus `:br' would suffice for `:break'.  The
  25. current commands are:
  26.  
  27. `:break'
  28.      Set a breakpoint in the specified FUNCTION at the specified LINE
  29.      offset from the beginning of the function.  If FUNCTION is given
  30.      as a string, then it is presumed to be a FILE and LINE is the
  31.      offset from the beginning of the file.
  32.  
  33. `:bt'
  34.      Undocumented
  35.  
  36. `:continue'
  37.      Continue the computation.
  38.  
  39. `:delete'
  40.      Delete all breakpoints, or if arguments are supplied delete the
  41.      specified breakpoints
  42.  
  43. `:disable'
  44.      Disable the specified breakpoints, or all if none are specified
  45.  
  46. `:enable'
  47.      Enable the specified breakpoints, or all if none are specified
  48.  
  49. `:frame'
  50.      With an argument print the selected stack frame.  Otherwise the
  51.      current frame.
  52.  
  53. `:help'
  54.      Print help on a break command or with no arguments on all break
  55.      commands
  56.  
  57. `:info'
  58.      Undocumented
  59.  
  60. `:lisp'
  61.      Evaluate the lisp form following on the line
  62.  
  63. `:lisp-quiet'
  64.      Evaluate its arg as a lisp form without printing a prompt.
  65.  
  66. `:next     Like :step, except that subroutine calls are stepped over'
  67.  
  68. `:quit'
  69.      Quit this level
  70.  
  71. `:resume'
  72.      Continue the computation.
  73.  
  74. `:step'
  75.      Step program until it reaches a new source line
  76.  
  77. `:top'
  78.      Throw to top level
  79.  
  80. 
  81. File: maxima.info,  Node: Definitions for Debugging,  Prev: Keyword Commands,  Up: Debugging
  82.  
  83. Definitions for Debugging
  84. =========================
  85.  
  86.  - Variable: REFCHECK
  87.      default: [FALSE] - if TRUE causes a message to be printed each
  88.      time a bound variable is used for the first time in a computation.
  89.  
  90.  
  91.  - Function: REMTRACE ()
  92.      This function is no longer used with the new TRACE package.
  93.  
  94.  
  95.  - Variable: SETCHECK
  96.      default: [FALSE] - if set to a list of variables (which can be
  97.      subscripted) will cause a printout whenever the variables, or
  98.      subscripted occurrences of them, are bound (with : or :: or
  99.      function argument binding).  The printout consists of the variable
  100.      and the value it is bound to.  SETCHECK may be set to ALL or TRUE
  101.      thereby including all variables.  Note: No printout is generated
  102.      when a SETCHECKed variable is set to itself, e.g. X:'X.
  103.  
  104.  
  105.  - Variable: SETCHECKBREAK
  106.      default: [FALSE] - if set to TRUE will cause a (MACSYMA-BREAK) to
  107.      occur whenever the variables on the SETCHECK list are bound.  The
  108.      break occurs before the binding is done.  At this point, SETVAL
  109.      holds the value to which the variable is about to be set.  Hence,
  110.      one may change this value by resetting SETVAL.
  111.  
  112.  
  113.  - Variable: SETVAL
  114.      - holds the value to which a variable is about to be set when a
  115.      SETCHECKBREAK occurs.  Hence, one may change this value by
  116.      resetting SETVAL.  (See SETCHECKBREAK).
  117.  
  118.  
  119.  - Function: TIMER (F)
  120.      will put a timer-wrapper on the function F, within the TRACE
  121.      package, i.e. it will print out the time spent in computing F.
  122.  
  123.  
  124.  - Variable: TIMER_DEVALUE
  125.      default: [FALSE] - when set to TRUE then the time charged against
  126.      a function is the time spent dynamically inside the function
  127.      devalued by the time spent inside other TIMED functions.
  128.  
  129.  
  130.  - Function: TIMER_INFO (F)
  131.      will print the information on timing which is stored also as
  132.      GET('F,'CALLS); GET('F,'RUNTIME); and GET('F,'GCTIME); .  This is
  133.      a TRACE package function.
  134.  
  135.  
  136.  - Function: TRACE (name1, name2, ...)
  137.      gives a trace printout whenever the functions mentioned are
  138.      called.  TRACE() prints a list of the functions currently under
  139.      TRACE.  On MC see MACDOC;TRACE USAGE for more information.  Also,
  140.      DEMO("trace.dem"); .  To remove tracing, see UNTRACE.
  141.  
  142.  
  143.  - Function: TRACE_OPTIONS (F,option1,option2,...)
  144.      gives the function F the options indicated.  An option is either a
  145.      keyword or an expression.  The possible Keywords are:  Keyword
  146.      Meaning of return value ---------------------------------------
  147.      NOPRINT     If TRUE do no printing.   BREAK       If TRUE give a
  148.      breakpoint.   LISP_PRINT  If TRUE use lisp printing.   INFO
  149.      Extra info to print.   ERRORCATCH  If TRUE errors are caught.  A
  150.      keyword means that the option is in effect.  Using a keyword as an
  151.      expression, e.g. NOPRINT(predicate_function) means to apply the
  152.      predicate_function (which is user-defined) to some arguments to
  153.      determine if the option is in effect. The argument list to this
  154.      predicate_function is always [LEVEL, DIRECTION, FUNCTION, ITEM]
  155.      where LEVEL is the recursion level for the function.  DIRECTION is
  156.      either ENTER or EXIT.  FUNCTION is the name of the function.  ITEM
  157.      is either the argument list or the return value.  On MC see
  158.      DEMO("trace.dem"); for more details.
  159.  
  160.  
  161.  - Function: UNTRACE (name1, ...)
  162.      removes tracing invoked by the TRACE function.  UNTRACE() removes
  163.      tracing from all functions.
  164.  
  165.  
  166.